package com.zui.base;

import java.io.Serializable;
import java.util.Collection;
import java.util.Iterator;
import java.util.List;
import java.util.Map;

import org.hibernate.Criteria;
import org.hibernate.criterion.Criterion;
import org.hibernate.criterion.DetachedCriteria;
import org.hibernate.criterion.Order;
import org.hibernate.criterion.Projections;

import com.zui.util.JQGridListImpl;
import com.zui.util.Page;

public interface EntityDao <T, ID extends Serializable>{
 
	public T findById(ID id); 
	
	public T findById(Class<T> c, ID id);

	public T loadById(ID id); 
	
	public T loadById(Class<T> c, ID id);
 
	public List<T> loadAll(); 

	public T saveEntity(T entity); 
 
	public void updateEntity(T entity); 

	public void saveOrUpdateAll(Collection<T> entities); 

	public void deleteEntity(T entity); 
 
	public void deleteEntityById(ID id); 


	/** 
	* 批量删除 
	* 
	* @param entities 
	*/ 
	public void deleteAll(Collection<T> entities); 

	/** 
	* 通过合并的方式更新对象
	* 
	* @param entity 
	* void 
	*/ 
	public void merge(T entity); 

	/*************************************************************************** 
	* ------------------------------使用HQL语句-------------------------------- * 
	**************************************************************************/ 

	/** 
	* 使用HQL语句进行对象的查询
	* 
	* @param hsql 
	* 查询语句 
	* @return 符合条件的对象
	*/ 
	public T getEntity(String hsql); 

	/** 
	* 使用HQL语句进行查询 
	* 
	* @param hsql 
	* 查询语句 
	* @return 符合条件的对象集集合
	*/ 
	public List<T> getEntities(String hsql); 

	/** 
	* 使用带参数的HQL语句进行查询 
	* 
	* @param hsql 
	* @param obj 
	* @return 
	*/ 
	public List<T> getEntities(String hsql, Object[] values); 

	public List<T> getEntities(String hql, int start, int number); 

	public List<T> getEntities(String hql, int start, int number, Object[] values); 

	/**
	 * 使用命名的HQL语句更新数据
	 * @param queryName
	 * @param values
	 */
	public int updateByNamedQuery(String queryName,Object[] values);
	/** 
	* 使用命名的HQL语句查询数据 
	* 
	* @param queryName 
	* @return 
	*/ 
	public List<T> findByNamedQuery(String queryName); 

	/** 
	* 使用带参数的命名HSQL语句查询数据 
	* 
	* @param queryName 
	* @param values 
	* @return 
	*/ 
	public List<T> findByNamedQuery(String queryName, Object[] values); 

	/** 
	* 使用带命名参数的命名HSQL语句�查询数据 
	* 
	* @param queryName 
	* @param paramNames 
	* @param values 
	* @return 
	*/ 
	public List<T> findByNamedQuery(String queryName, String[] paramNames, 
	Object[] values); 

	/** 
	* 使用HQL语句查询数据 ，返回Iterator 
	* 
	* @param queryString 
	* @return 
	*/ 
	public Iterator<T> iterate(String queryString); 

	/** 
	* 使用带参数HSQL语句查询数据，返回Iterator 
	* 
	* @param queryString 
	* @param values 
	* @return 
	*/ 
	public Iterator<T> iterate(String queryString, Object[] values); 

	/*************************************************************************** 
	* -----------------------------Criteria查询---------------------------- * 
	**************************************************************************/ 

	/** 
	* 创建与会话无关的查询数据 
	*/ 
	public DetachedCriteria createDetachedCriteria(); 

	/** 
	* 创建与会话绑定的查询数据标准对象 
	* 
	* @return 
	*/ 
	public Criteria createCriteria(); 

	/** 
	* 使用指定的检索标准检索数据，返回部分记录 
	* 
	* @param criteria 
	* @param firstResult 
	* @param maxResults 
	* @return 
	*/ 
	public List<T> findByCriteria(DetachedCriteria criteria, int firstResult, 
	int maxResults); 

	/** 
	* 通过动态查询条件进行查询
	* 
	* @param criterion 
	* @return List<T> 
	*/ 
	public List<T> findByCriteria(Criterion... criterion); 

	/** 
	* 使用指定的检索标准检索数据，返回指定范围的记录
	* 
	* @param criteria 
	* @return 
	*/ 
	public Integer getRowCount(DetachedCriteria criteria); 

	/** 
	* 使用指定的检索标准检索数据，返回指定统计记录
	* 
	* @param criteria 
	* @param propertyName 
	* @param StatName 
	* (max,min,avg,sum) 
	* @return 
	*/ 
	public Object getStatValue(DetachedCriteria criteria, String propertyName, 
	String StatName); 

	/** 
	* 通过给定的一个对象，查找与其匹配的对象，表关联比较多时，可根据自己需要扩展
	* 
	* @param entity 
	* @return List<T> 
	*/ 
	public List<T> findByExample(T entity); 

	/*************************************************************************** 
	* -------------------------Others ----------------------------------------* 
	**************************************************************************/ 

	/** 
	* 强制立即更新缓冲数据到数据库（否则仅在事务提交时才更新） 
	*/ 
	public void flush(); 

	/** 
	* 清空缓存 
	* 
	* void 
	*/ 
	public void clear(); 
	public void evict(T entity);
	/**
	 * 根据criteria和orderList进行分页查询。
	 * 
	 * 出于性能考虑排序信息请勿放在criteria里，由本方法负责。
	 * 
	 * @param criteria
	 *            查询条件
	 * @param page
	 *            分页信息
	 * @param orderList
	 *            定制化的排序列表
	 * @return 包含分页信息的对象列表。对象为根对象。
	 * @deprecated
	 */
	public List<T> findByCriteria(DetachedCriteria criteria,Page page, List<Order> orderList) ;

	/**
	 * 根据criteria进行分页查询。
	 * 
	 * @param criteria
	 *            查询条件
	 * @param page
	 *            分页信息
	 * @return 对象为根对象。
	 * @deprecated
	 */
	public List<T> findByCriteria(DetachedCriteria criteria, Page page);

	/**
	 * 无分页查询
	 * 
	 * @param criteria
	 * @return 根对象的列表。
	 */
	public List<T> findByCriteria(DetachedCriteria criteria) ;
	
	/**
	 * 按属性查找唯一对象.
	 */
	public T findUniqueByProperty(String propertyName, Object value);
	
	public List<T> createSQLQuery(String nativeSql);
	

	/**
	 * 根据criteria和orderList进行分页查询。
	 * 
	 * 出于性能考虑排序信息请勿放在criteria里，由本方法负责。
	 * 
	 * @param criteria
	 *            查询条件
	 * @param page
	 *            分页信息
	 * @param orderList
	 *            定制化的排序列表
	 * @return JQGridListImpl,包含分页信息的对象列表。对象为根对象。
	 */
	public List<T> findByCriteriaForJQGrid(DetachedCriteria criteria, Page page,
			List<Order> orderList);
	/**
	 * 根据criteria进行分页查询。
	 * 
	 * @param criteria
	 *            查询条件
	 * @param page
	 *            分页信息
	 * @return 对象为根对象。
	 */
	public List<T> findByCriteriaForJQGrid(DetachedCriteria criteria, Page page);
}
